home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / include / scribus-ng / sampleitem.h < prev    next >
Encoding:
C/C++ Source or Header  |  2007-07-23  |  3.8 KB  |  122 lines
  1. /*
  2. For general Scribus (>=1.3.2) copyright and licensing information please refer
  3. to the COPYING file provided with the program. Following this notice may exist
  4. a copyright and/or license notice that predates the release of Scribus 1.3.2
  5. for which a new license (GPL+exception) is in place.
  6. */
  7. #ifndef SAMPLEITEM_H
  8. #define SAMPLEITEM_H
  9.  
  10. #include <QObject>
  11. #include <QPixmap>
  12. #include "scribusapi.h"
  13. #include "scribusstructs.h"
  14.  
  15. class QString;
  16. class QColor;
  17. class ScribusDoc;
  18.  
  19.  
  20. /*! \brief Provides sample "text frame" as pixmap.
  21. You can create a pixmap with standard Scribus text frame
  22. here. It can be used as a kind of preview.
  23. It needs at least one existing ScribusDoc - so there
  24. is one created if ScWM->doc is null (then it's destroyed
  25. of course).
  26. SampleItem creates 2 temporary colors in scribus document -
  27. Black and white - to be sure to display B/W preview correctly
  28. every time. These color are renoved in descructor. Or used
  29. cleanupTemporary() method.
  30. \warning Be sure there will be called destructor or cleanupTemporary()
  31. at the end of work with it!
  32. \author Petr Vanek <petr@yarpen.cz>
  33. */
  34. class SCRIBUS_API SampleItem : QObject
  35. {
  36.     Q_OBJECT
  37.  
  38.     public:
  39.         SampleItem(ScribusDoc* doc);
  40.         ~SampleItem();
  41.  
  42.         /*! \brief Set sample text.
  43.         \param aText QString to set. */
  44.         void setText(QString aText);
  45.         /*! \brief Use lorem ipsum generator as text source.
  46.         \param para count of the LI paragraphs */
  47.         void setLoremIpsum(int para);
  48.         /*! \brief Set backgroud color of the pixmap.
  49.         \param c a QColor */
  50.         void setBgColor(QColor c);
  51.         void setBgShade(int c);
  52.         /*! \brief Set color management for backgroud color of the pixmap.
  53.         \param enable if color management should be enabled */
  54.         void setBgColorMngt(bool enable);
  55.         /*! \brief Set Text color of the pixmap.
  56.         \param c a QColor */
  57.         void setTxColor(QColor c);
  58.         void setTxShade(int c);
  59.  
  60.         /*! \brief Set whole Scribus paragraph style in one.
  61.         \param aStyle Paragraph style to set.*/
  62.         void setStyle(const ParagraphStyle& aStyle);
  63.         /*! \brief Folowing methods set only one style characteristic */
  64.         void setLineSpaMode(int lineSpaMode);
  65.         void setLineSpa(double lineSpa);
  66.         void setTextAlignment(int textAlignment);
  67.         void setIndent(double indent);
  68.         void setRightMargin(double indent);
  69.         void setFirst(double first);
  70.         void setGapBefore(double gapBefore);
  71.         void setGapAfter(double gapAfter);
  72.         void setFont(QString font);
  73.         /*! \brief Set size of the font.
  74.         \param fontSize fontSize * 10.0 usually
  75.         \param autoLineSpa if true - use automatic line spacing computing */
  76.         void setFontSize(int fontSize, bool autoLineSpa=false);
  77.         //void setTabValues(QValueList<PageItem::TabRecord> tabValues);
  78.         void setDrop(bool drop);
  79.         void setDropLin(int dropLin);
  80.         void setDropDist(double dropDist);
  81.         void setFontEffect(int fontEffect);
  82.         void setFColor(QString fColor);
  83.         void setFShade(int fShade);
  84.         void setSColor(QString sColor);
  85.         void setSShade(int sShade);
  86.         void setBaseAdj(bool baseAdj);
  87.         void setTxtShadowX(int txtShadowX);
  88.         void setTxtShadowY(int txtShadowY);
  89.         void setTxtOutline(int txtOutline);
  90.         void setTxtUnderPos(int txtUnderPos);
  91.         void setTxtUnderWidth(int txtUnderWidth);
  92.         void setTxtStrikePos(int txtStrikePos);
  93.         void setTxtStrikeWidth(int txtStrikeWidth);
  94.         void setScaleH(int scaleH);
  95.         void setScaleV(int scaleV);
  96.         void setBaseOff(int baseOff);
  97.         void setKernVal(int kernVal);
  98.  
  99.         /*! \brief Get the sample.
  100.         \param width W of the sample
  101.         \param height H of the sample
  102.         \retval QPixmap rendered image
  103.         */
  104.         QPixmap getSample(int width, int height);
  105.         /*! \brief Remove the tmp issues. */
  106.         void cleanupTemporary();
  107.  
  108.     private:
  109.         //! \brief Text to be rendered
  110.         QString text;
  111.         //! \brief Internal temporary paragraph style
  112.         ParagraphStyle tmpStyle;
  113.         /*! \brief Reference to a document.
  114.         Existing or created one */
  115.         ScribusDoc *m_Doc;
  116.         //! \brief Is the doc created used only? true = used
  117.         bool used;
  118.         int bgShade;
  119. };
  120.  
  121. #endif
  122.